Modernize explanation of `build.rs`
authorFrank McSherry <fmcsherry@me.com>
Sun, 6 Aug 2017 20:57:13 +0000 (16:57 -0400)
committerGitHub <noreply@github.com>
Sun, 6 Aug 2017 20:57:13 +0000 (16:57 -0400)
commitb2c597a8a2df4f7d3b5c55ef3583b3c9a25f604d
treee262cd56f0747ecfea9c90684f2c286952ffb2e3
parentfd5771b99b2e4c59b93675352363f9503b7d3a2d
Modernize explanation of `build.rs`

After some recent head-banging, it was explained to me that `"build.rs"` is a special file name, and that Cargo will build such a file even if you do not expect it to, for example if `Cargo.toml` contains the commented out line

```
#build = "build.rs"
```

Some experimentation lead me to the described behavior, but if it misses any subtle details please feel free to correct. The old text is incorrect, though.
src/doc/build-script.md